Optional: Add a manually-created berths.txt file to XPS

N4 supports the automated pushing of the berths.txt file from the N4 database to the cache and then to XPS. This support means that when you apply yard model changes (and have an existing berth model), N4 automatically generates and pushes the berths.txt file to the cache (through the Mule Enterprise Service Bus) so that XPS can load the berths.txt file, just like it loads the yard.nyd file.

If a berth model does not exist, N4 logs a message at the info level that the berth model does not exist and that for this reason, no berths.txt file has been generated. If for any reason the text file pushed out by N4 has bad data or is corrupted, XPS has the flexibility to switch to another berths.txt file.

N4 prevents a manually-created berths.txt file from being overwritten. However, if it is necessary for XPS to ignore the N4-generated berths.txt file, you can add a manually-created berths.txt file to XPS.

Before you begin:

You must have a manually-created berths.txt file.

To add a manually-created berths.txt file to XPS:

  1. Add the following line to the settings.xml configuration file located on the XPS server at C:\ProgramData\Navis\xps:
    <overwrite_berth_file>false</overwrite_berth_file>

  1. Place a correct berths.txt file in the data folder on the XPS server ( C:\ProgramData\Navis\xps\data).

  2. Restart XPS.